METHOD:
Window::open
window.open(URL,
name [, features])
This method is used
to open a new browser window. Note that, when using this method with event
handlers, you must use the syntax window.open() as opposed to just
open(). Calling just open() will, because of the scoping
of static objects in JavaScript, create a new document (equivalent to
document.open()), not a window.
The available parameters are as follows:
URL - this is a string containing the URL of
the document to open in the new window. If no URL is specified, an empty
window will be created.
name - this is a string containing the name of
the new window. This can be used as the 'target' attribute of a <FORM>
or <A> tag to point to the new window.
features - this is an optional string that contains
details of which of the standard window features are to be used with the
new window. This takes the form of a comma-delimited list. Most of these
features require yes or no (1 or 0 is also o.k.) and any of these can
be turned on by simply listing the feature (they default to yes). Also,
if you don't supply any of the feature arguments, all features with a
choice of yes or no are enabled; if you do specify any feature parameters,
titlebar and hotkeys still default to yes but all others
are no. Details of the available features are given below.
| alwaysLowered |
When
set to yes, this creates a window that always floats below other
windows. |
| alwaysRaised |
When
set to yes, this creates a window that always floats above other
windows. |
| dependent |
When
set to yes, the new window is created as a child (closes when the
parent window closes and does not appear on the task bar on Windows
platforms) of the current window. |
| directories |
When
set to yes, the new browser window has the standard directory buttons. |
| height |
This
sets the height of the new window in pixels. |
| hotkeys |
When
set to no, this disables the use of hotkeys (except security and
quit hotkeys) in a window without a menubar. |
| innerHeight |
This
sets the inner height of the window in pixels. |
| innerWidth |
This
sets the inner width of the window in pixels. |
| location |
When
set to yes, this creates the standard Location entry feild in the
new browser window. |
| menubar |
When
set to yes, this creates a new browser window with the standard
menu bar (File, Edit, View, etc.). |
| outerHeight |
This
sets the outer height of the new window in pixels. |
| resizable |
When
set to yes this allows the resizing of the new window by the user. |
| screenX |
This
allows a new window to be created at a specified number of pixels
from the left side of the screen. |
| screenY |
This
allows a new window to be created at a specified number of pixels
from the top of the screen. |
| scrollbars |
When
set to yes the new window is created with the standard horizontal
and vertical scrollbars, where needed |
| status |
When
set to yes, the new window will have the standard browser status
bar at the bottom. |
| titlebar |
When
set to yes the new browser window will have the standard title bar. |
| toolbar |
When
set to yes the new window will have the standard browser tool bar
(Back, Forward, etc.). |
| width |
This
sets the width of the new window in pixels. |
| z-lock |
When
set to yes this prevents the new window from rising above other
windows when it is made active (given focus). |
These features may only be used with IE4:
| channelmode |
sets if the window appears in channel mode. |
| fullscreen |
the new window will appear in full screen. |
| left |
same as screenX, allows a new window to be created at a specified number of pixels
from the left side of the screen. |
| top |
same as screenY, allows a new window to be created at a specified number of pixels
from the top of the screen. |
The following example creates a new window of the specified dimensions
complete with toolbar, changes the background color and writes a message
to it.
Code:
myWindow = window.open("", "tinyWindow", 'toolbar,width=150,height=100')
myWindow.document.write("Welcome to this new window!")
myWindow.document.bgColor="lightblue"
myWindow.document.close()
Output:
 |